To customize the Authelia login screen, you need to understand that Authelia's design philosophy is "security first." Consequently, it doesn't have a theme editor in the UI. Instead, customization is handled through the configuration.yml file or by custom building the frontend.
For your B2-C1 English level, here is a concise guide on how to implement these changes.
---
1. The Easy Way: Built-in Theming
As of recent versions, Authelia supports basic theme selection (Light, Dark, or Grey) and custom branding via the configuration file.
Add the following to your configuration.yml:
YAML
theme: 'dark' # Options: light, dark, grey, auto
server:
# This adds your logo and a custom message to the login page
custom_assets:
path: /config/assets/
Adding Your Logo
-
Create a folder: /mnt/disk2/docker/authelia/config/assets/.
-
Place a file named logo.png (transparent background recommended) in that folder.
-
Authelia will automatically detect this and replace the default logo on the login screen.
---
2. Customizing the Brand Name
If you want to change the text that appears in the browser tab and on the login header, use the telemetry and server blocks:
YAML
server:
headers:
csp:
# Optional: Hardening headers if you use external assets
script-src: "'self'"
# This changes the "powered by Authelia" or page titles in some versions
telemetry:
metrics:
enabled: false
---
3. Advanced Customization: Custom CSS
Authelia does not natively support an "extra-css.css" file in the standard configuration yet. If you want to change colors (e.g., making the buttons blue instead of the default orange), you have two choices:
Option A: Use a Reverse Proxy (Traefik) Injector
You can use a Traefik plugin or a middleware (like a "Replace Path" or a specialized header injector) to inject a custom CSS stylesheet into the Authelia page. This is quite advanced and can be brittle.
Option B: Build from Source
If you are comfortable with Docker builds, you can clone the Authelia repository, modify the React files in the web directory, and build your own custom Docker image.
---
4. Customizing Redirection and Links
You can customize where users go after they log in or what links they see for password resets.
YAML
identity_validation:
reset_password:
# This must point to your auth domain
html_template: /config/email_template.html
---
Summary of what you can change easily:
| Element | Method |
|---|---|
| Logo | Drop logo.png into the custom_assets folder. |
| Theme | Set theme to dark, light, or grey. |
| Favicon | Drop favicon.ico into the custom_assets folder. |
| App Name | Controlled via various metadata fields in config. |
Since you've fixed the 500 error and the container is running, would you like me to show you the specific folder structure needed to get your logo appearing on that login screen?